<h1>RemoveObject</h1>

<p>RemoveObject removes an object from the Flash Player's Display List. An 
object placed on the display list is displayed in every frame of a movie until 
it is explicitly removed. Objects must also be removed if its location or 
appearance is changed using either the PlaceObject or PlaceObject2 instructions.</p>

<table>

<tr>
<th nowrap>Field Name</th>
<th>Type</th>
<th>Size</th>
<th>Description</th>
</tr>

<tr>
<td nowrap valign="top">type</td>
<td nowrap valign="top">unsigned bit</td>
<td nowrap valign="top" align="right">10</td>
<td>Identifies the PlaceObject instruction when it is encoded. It is encoded 
with the length field as a 16-bit integer (Little-endian byte order).</td>
</tr>

<tr>
<td nowrap valign="top">length</td>
<td nowrap valign="top">unsigned bit</td>
<td nowrap valign="top" align="right">6</td>
<td>The length in bytes of the body of the instruction when it is encoded. If the length is greater 
than 62 then this field is set to 0x3F and the length is encoded using the 
extendedLength field. Encoded with the type field as a 16-bit integer.</td>
</tr>

<tr>
<td nowrap valign="top">extendedLength</td>
<td nowrap valign="top">unsigned int</td>
<td nowrap valign="top" align="right">32</td>
<td>Optional. Contains the length in bytes of the encoded instruction if it is
greater than 62 bytes. If the length is 62 bytes or less then this field is 
omitted.</td>
</tr>

<tr>
<td nowrap valign="top">identifier</td>
<td nowrap valign="top">unsigned int</td>
<td nowrap valign="top" align="right">16</td>
<td>The identifier of the object to added to the display list.</td>
</tr>

<tr>
<td nowrap valign="top">layer</td>
<td nowrap valign="top">unsigned int</td>
<td nowrap valign="top" align="right">16</td>
<td>Defines the order in which objects are displayed.</td>
</tr>

</table>

<p>Although only one object can be placed on any layer in the display list 
both the object's unique identifier and the layer number must be specified. 
The RemoveObject instruction is superceded in Flash 3 by RemoveObject2 
which lifts this requirement allowing an object to be referenced by the layer 
number it occupies in the display list.</p>

<h2>History</h2>

<p>The RemoveObject instruction represents the RemoveObject tag from the Macromedia 
Flash (SWF) File Format Specification. It was introduced in Flash 1 and is 
superceded by the RemoveObject2 tag which was added in Flash 3.</p>
